Extra python modules/ro

Locație

Documentația sursă

Indeks

Overview

PySide

Notă: FreeCAD sa mutat progresiv de la PyQt după versiunea 0.13, în favoareaPySide, care face exact același lucru, dar are o licență (LGPL) mai compatibilă cu FreeCAD.

Instalarea

Linux

Windows

MacOS

Usage

import PySide

To access the FreeCAD interface, type :

from PySide import QtCore,QtGui
FreeCADWindow = FreeCADGui.getMainWindow()

Acum puteți începe să explorați interfața cu comanda dir (). Puteți adăuga elemente noi, cum ar fi un widget personalizat, cu comenzi cum ar fi:

FreeCADWindow.addDockWidget(QtCore.Qt.RghtDockWidgetArea,my_custom_widget)

Working with Unicode :

text = text.encode('utf-8')

Working with QFileDialog and OpenFileName :

path = FreeCAD.ConfigGet("AppHomePath")
#path = FreeCAD.ConfigGet("UserAppData")
OpenName, Filter = PySide.QtGui.QFileDialog.getOpenFileName(None, "Read a txt file", path, "*.txt")

Working with QFileDialog and SaveFileName :

path = FreeCAD.ConfigGet("AppHomePath")
#path = FreeCAD.ConfigGet("UserAppData")
SaveName, Filter = PySide.QtGui.QFileDialog.getSaveFileName(None, "Save a file txt", path, "*.txt")

Additional documentation

• Qt official documentation site

Pivy

Instalare

Prerequisites

Am găsit că pentru construirea pe Mac a fost suficient pentru a instala Coin3 binary package. Încercarea de a instala coin de la MacPorts a fost problematică: a încercat să adauge o mulțime de pachete X Windows și în cele din urmă s-a prăbușit cu o eroare de script.

For Fedora I found an RPM with Coin3.

SoQt compiled from source fine on Mac and Linux.

Debian & Ubuntu

Cea mai bună modalitate de a compila pivy cu ușurință este să luați pachetul sursă debian pentru pivy și să faceți un pachet cu debuild. Este același cod sursă de pe site-ul oficial pivy, dar oamenii de la debian au făcut mai multe adăugări de fixare a bug-urilor. De asemenea, compilează bine karmicul ubuntu: http://packages.debian.org/squeeze/python-pivy descărcați fișierul .orig.gz și .diff.gz, apoi dezarhivați ambele, apoi aplicați .diff la sursă: mergeți la directorul sursă de pivy dezarhivate și aplicați patch-ul .diff:

patch -p1 < ../pivy_0.5.0~svn765-2.diff

then

debuild

to have pivy properly built into an official installable package. Then, just install the package with gdebi.

Other Linux distributions

Information to be added.

As of March 2012, the latest version is Pivy-0.5.

Apoi aveți nevoie de un instrument numit SWIG pentru a genera codul C++ pentru legăturile Python. Pivy-0.5 raportează că a fost testată numai cu SWIG 1.3.31, 1.3.33, 1.3.35 și 1.3.40. Deci, puteți descărca o sursă tarball pentru una dintre aceste versiuni vechi de la http://www.swig.org. Then unpack it and from a command line do (as root):

./configure
make
make install (or checkinstall if you use it)

Ia doar câteva secunde compilarea.

După aceea, mergeți la sursele de pivy și sunați

python setup.py build

which creates the source files. Note that build can produce thousands of warnings, but hopefully there will be no errors.

Acest lucru este probabil depășit, însă este posibil să întâmpinați o eroare de compilator în care un "const char *" nu poate fi convertit într-un 'char *'. Pentru a repara că trebuie doar să scrieți un "const" înainte în liniile corespunzătoare. Există șase linii de rezolvat.

După asta, instalați by issuing (ca root):

python setup.py install (or checkinstall python setup.py install)

Et voila, pivy este instalat.

MacOS

În ceea ce privește linux, obțineți cea mai recentă sursă:

hg clone http://hg.sim.no/Pivy/default Pivy

Dacă nu aveți hg, îl puteți obține de la MacPorts:

port install mercurial

Then, as above you need SWIG. It should be a matter of:

port install swig

I found I needed also:

port install swig-python

Acest lucru poate fi corectat prin editarea celor două locații sursă pentru a adăuga dereferențe: *arg4, *arg5 in place of arg4, arg5. Now Pivy should build:

python setup.py build
sudo python setup.py install

Windows

set PATH=path_to_python_3.x;%PATH%

Pentru a obține o pivă de lucru, ar trebui să obțineți cele mai recente surse din depozitul proiectului:

Information to be added.

Apoi aveți nevoie de un instrument numit SWIG pentru a genera codul C++ pentru legăturile Python. Se recomandă utilizarea versiunii 1.3.25 a SWIG, nu cea mai recentă versiune, deoarece în acest moment pivy va funcționa corect numai cu 1.3.25. Descărcați binarele pentru 1.3.25 de la http://www.swig.org. Apoi despachetați-l și din linia de comandă adăugați-l pe calea sistemului

set PATH=path_to_swig_1.3.25;%PATH%

și setați COINDIR pe calea potrivită

set COINDIR=path_to_coin

Pe Windows, fișierul config pivy se așteaptă ca SoWin în loc de SoQt ca implicit. Nu am găsit o modalitate evidentă de a construi cu SoQt, așa că am modificat fișierul setup.py direct. În linia 200, scoateți doar partea "sowin": ('gui._sowin', 'sowin-config', 'pivy.gui.') (Nu scoateți paranteza de închidere).

After that go to the pivy sources and call

python setup.py build

care creează fișierele sursă. S-ar putea să întâlniți o eroare de compilator că nu au putut fi găsite mai multe fișiere antet. În acest caz, ajustați variabila INCLUDE

set INCLUDE=%INCLUDE%;path_to_coin_include_dir

și dacă antetele SoQt nu se află în același loc ca și antetele de Coin

set INCLUDE=%INCLUDE%;path_to_soqt_include_dir

și în final anteturile Qt

set INCLUDE=%INCLUDE%;path_to_pyside\include\Qt

Mergeți la linia 122 și înlocuiți linia de cod

vsbase = r"Software\Microsoft\VisualStudio\%0.1f" % version

cu

vsbase = r"Software\Microsoft\VCExpress\%0.1f" % version

error: Python was built with Visual Studio 2003;...

trebui să înlocuiți și linia 128

self.set_macro("FrameworkSDKDir", net, "sdkinstallrootv1.1")

cu

self.set_macro("FrameworkSDKDir", net, "sdkinstallrootv2.0")

Reîncercați încă o dată. Dacă apare din nou o eroare cum ar fi

error: Python was built with Visual Studio version 8.0, and extensions need to be built with the same version of the compiler, but it isn't installed.

then you should check the environment variables DISTUTILS_USE_SDK and MSSDK with

echo %DISTUTILS_USE_SDK%
echo %MSSDK%

If not yet set then just set it e.g. to 1

set DISTUTILS_USE_SDK=1
set MSSDK=1

Usage

import pivy

To have Pivy access the FreeCAD scenegraph do the following:

from pivy import coin
App.newDocument() # Open a document and a view
view = Gui.ActiveDocument.ActiveView
FCSceneGraph = view.getSceneGraph() # returns a pivy Python object that holds a SoSeparator, the main "container" of the Coin scenegraph
FCSceneGraph.addChild(coin.SoCube()) # add a box to scene

You can now explore the FCSceneGraph with the dir() command.

Additonal Documentation

You can also look at the Draft.py file in the FreeCAD Mod/Draft folder, since it makes big use of pivy.

pyCollada

Installation

Linux

sudo apt-get install python3-collada

import collada

If it returns nothing (no error message), then all is OK

Linux AppImages and Snaps

Paste this code in the Python console:

import addonmanager_utilities as utils
import subprocess
import os

if hasattr(utils, "get_python_exe"):
    # For v0.21:
    python_exe = utils.get_python_exe()
else:
    # For v0.22/v1.0:
    from freecad.utils import get_python_exe

python_exe = get_python_exe()
vendor_path = utils.get_pip_target_directory()
if not os.path.exists(vendor_path):
    os.makedirs(vendor_path)

subprocess.run(
    [
        python_exe,
        "-m",
        "pip",
        "install",
        "--disable-pip-version-check",
        "--target",
        vendor_path,
        "pycollada",
    ],
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    timeout=120,
    check=True,
)

Windows

Pe Windows, de la 0.15 pycollada este inclus atât în versiunea FreeCAD, cât și în versiunea dezvoltatorului, deci nu sunt necesare pași suplimentari.

Dacă utilizați buildul Homebrew al FreeCAD, puteți instala pycollada în sistemul dvs. Python folosind pip.

If you need to install pip:

$ sudo easy_install pip

Install pycollada:

$ sudo pip install pycollada

Dacă utilizați o versiune binară a FreeCAD, puteți spune pip-ului să instaleze pycollada în pachetele de site-uri din cadrul FreeCAD.app:

$ pip install --target="/Applications/FreeCAD.app/Contents/lib/python3.x/site-packages" pycollada

sau după descărcarea codului pycollada

$ export PYTHONPATH=/Applications/FreeCAD\ 0.16.6706.app/Contents/lib/python3.x/site-packages:$PYTHONPATH
$ python setup.py install --prefix=/Applications/FreeCAD\ 0.2x.yyyy.app/Contents

IfcOpenShell

• homepage: http://www.ifcopenshell.org
• license: LGPL
• optional, needed to extend import abilities of IFC files

Installation

Linux

Installation instructions can be found here.

import ifcopenshell

If it returns nothing (no error message), then all is OK

Windows and macOS

IfcOpenShell is included in both the FreeCAD release and developer builds so no additional steps are necessary.

Links

LazyLoader

LazyLoader is a Python module that allows deferred loading, while still importing at the top of the script. This is useful if you are importing another module that is slow, and it is used several times throughout the script. Using LazyLoader can improve workbench startup times, but the module will still need to be loaded on first use.

Installation

LazyLoader is included with FreeCAD v0.19

Usage

You will need to import LazyLoader, then change the import of whatever module you want to be deferred.

from lazy_loader.lazy_loader import LazyLoader
Part = LazyLoader('Part', globals(), 'Part')

The variable Part is how the module is named in your script. You can replicate "import Part as P" by changing the variable.

P = LazyLoader('Part', globals(), 'Part')

You can also import a module from a package.

utils = LazyLoader('PathScripts', globals(), 'PathScripts.PathUtils')

You can't import individual functions, just entire modules.

Links

• Original source: https://github.com/tensorflow/tensorflow/blob/master/tensorflow/python/util/lazy_loader.py
• Further explanation: https://wil.yegelwel.com/lazily-importing-python-modules/
• Code within the FreeCAD source code: https://github.com/FreeCAD/FreeCAD/tree/master/src/3rdParty/lazy_loader
• Forum discussion: https://forum.freecadweb.org/viewtopic.php?f=10&t=45298

Locație

Documentația sursă

Indeks

User documentation

• Getting started
• Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
• Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

---

• Help: Tutorials, Video tutorials
• Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub